<!DOCTYPE html><html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    <title>Yoshimi User Manual ~ Filters</title>
    <link rel="stylesheet" type="text/css" href="../files/style.css">
  </head>
  <body>
    <nav class="navbar">
      <a href="../index.html">Index</a>
    </nav>
    <h2 style="text-align: center">Filter Types</h2>
    <img src="images/filter.png" alt="Filter Window" class="image">
    <p>
    These controls are identical across all engines and also available in the <a href="../effects/effects.html#dynfilter">DynFilter</a> effect.
    </p>
    <p>
      <ul>
      <li>
          <b>Category</b> Filter category: Analog, Formant or State Variable (StateVar)
      </li>
      <li>
          <b>St.</b> Filter stages (1 to 5)
      </li>
      <li>
          <b>Filter Type or Edit</b> This depends on the selected filter category. For Analog and StateVar various filters can be selected. For Formant a window enabling you to graphically edit the formants is opened
      </li>
      <li>
          <b>C.freq/BS.pos</b> Centre Frequency for Analog and StateVar. Base position of the vowel sequence for Formant
      </li>
      <li>
        <b>Q</b> Q factor for the filter
      </li>
      <li>
        <b>V.Sns.</b> Velocity sensing. How much the filter is influenced by (MIDI) velocity of the note
      </li>
      <li>
        <b>VF.Sns.</b> Velocity sensing function i.e the curve it follows.
      </li>
      <li>
        <b>Gain</b> Filter output gain
      </li>
      <li>
        <b>Freq.tr.</b> Amount of frequency tracking for the filter. If this is positive (rightmost) higher note frequencies will shift the filter cutoff frequency higher. Default range is -100% to 98.4% unless the checkbox above ('- / +') is selected: in this case the range is 0% to 198.4%
      </li>
    </ul>
    </p>
    <img src="../images/boundry.png" alt="divider" class="wideline">
    <h3 style="text-align: center">The Formant Filter</h3>
    <img src="images/formant.png" alt="Formant Window" class="image">
    <p>
    When the formant window is selected, the <em>FilterType</em> list is replaced by an Edit button, and clicking on this opens the window shown. These controls are <em>additional</em> to the others and adjust individual formants and the vowels they are contained in.  Also, remember that the formant filter interacts with the filter envelope.
    <br><br>
    There are six vowels each with 12 formants, although you can chose to use only 2 or 3 of these.
    <br><br>
    For a deep understanding of formant filtering there is a highly detailed Wikipedia article <a href="https://en.wikipedia.org/wiki/Formant">Here</a>.
    </p>
    <p>
    <ul>
      <li>
        <b>Formants</b> The number of active formants.
      </li>
      <li>
        <b>Fr.Sl</b> (formant slowness) The rate at which one vowel morphs to the next.
      </li>
      <li>
        <b>Vw.Cl</b> (vowel clearness) The amount of overlap when vowels transition.
      </li>
      <li>
        <b>Vowel no.</b> The vowel being edited. If you are editing one that isn't in the current sequence it will have a redish background.
      </li>
      <li>
        <b>Formant</b> The formant being edited.
      </li>
      <li>
        <b>Freq</b> The frequency of the current formant. Uniquely this has no default value. From Yoshimi V2.3.0 there is a  <a href="#pseudo">pseudo default</a>.
      </li>
      <li>
        <b>Q</b> The current formant's Q factor.
      </li>
      <li>
        <b>Amp</b> The amplitude of the current formant.
      </li>
      <li>
        <b>Seq.Size</b> (sequence size) The number of active vowels.
      </li>
      <li>
        <b>S.Pos.</b> (sequence position) The order of the vowels.
      </li>
      <li>
        <b>Vowel</b> The vowel number at the sequence position shown.
      </li>
      <li>
        <b>Stretch</b> Changes the time and width of lower frequency formants relative to higher ones.
      </li>
      <li>
        <b>Neg.Input</b> Inverts the input from the Envelope and/or LFO.
      </li>
      <li>
        <b>C.f.</b> (centre frequency) The centre point of the complete filter.
      </li>
      <li>
        <b>Oct.</b> (octaves) The pitch range of the complete filter.
      </li>
    </ul>
    <b>Note</b>
    <div class="tab">
    Although the sequence size sets the number of active vowels it doesn't determine which ones can be selected for any sequence position. If you have three vowels active (the default) you could have vowels 6, 3, 4 at positions 1, 2, 3 respectively.
    </div>
    </p>
    <p>
    <h4>The Formant Graph</h4>
    You can control some of the parameters by placing the mouse pointer over the yellow lines representing each formant. While making changes, the respective controls will move accordingly.
    <br><br>
    Holding down either <em>left</em> or <em>right</em> mouse buttons and moving the mouse sideways will change the formant's center frequency.
    <br><br>
    Moving vertically while holding down the <em>left</em> button will change the amplitude. Alternatively holding down the <em>right</em> button changes the formant's Q factor.
    <br><br>
    Anywhere on the graph, the <em>scroll-wheel</em> changes the octave range, and holding <em>Shift</em> at the same time changes the center frequency.
    <br><br>
    If your mouse has extra buttons on the sides (many haven't) these can be used to switch between the formants instead of moving the mouse across to the next one.
    <br><br>
    This is especially useful for controlling most of the formant features one-handed, quickly, while also playing on a keyboard.
    </p>
    <p>
    <a id="pseudo"></a>
    <h4>The Formant Pseudo Default</h4>
    When a formant filter is first created the frequency control for each of the individual formants will be set randomly. However, with Yoshimi versions V2.3.0 and later, this setting becomes a pseudo default and the knob pointer colour will behave accordingly.
    <br>
    An extra wrinkle is that if this has been changed and the instrument is then saved, the saved copy will have the <em>current</em> value marked as the default, without affecting the running version.
    <br>
    Also, keep in mind that a reset, or switching to a different filter type always clears all filter settings and the formant frequency controls will gain new random values.
    </p>
    <!--<a href="../navigation/navigation.html">Next</a> (Navigation, Controls, Defaults)-->
  </body>
</html>
